package xiaozhi.modules.sys.service;

import java.util.List;
import java.util.Map;

import xiaozhi.common.page.PageData;
import xiaozhi.common.service.BaseService;
import xiaozhi.modules.sys.dto.SysApiKeyDTO;
import xiaozhi.modules.sys.entity.SysApiKeyEntity;

/**
 * API密钥管理
 */
public interface SysApiKeyService extends BaseService<SysApiKeyEntity> {

    PageData<SysApiKeyDTO> page(Map<String, Object> params);

    List<SysApiKeyDTO> list(Map<String, Object> params);

    SysApiKeyDTO get(Long id);

    void save(SysApiKeyDTO dto);

    void update(SysApiKeyDTO dto);

    void delete(String[] ids);
    
    /**
     * 根据API密钥获取实体
     * @param apiKey API密钥
     * @return API密钥实体
     */
    SysApiKeyEntity getByApiKey(String apiKey);
    
    /**
     * 生成新的API密钥
     * @return API密钥字符串
     */
    String generateApiKey();
}